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Special Notices 


O 


References in this publication to IBM products, programs, or services do not imply 
that IBM intends to make these available in all countries in which IBM operates. 

Any reference to an IBM product, program, or service is not intended to state or 
imply that only IBM's product, program, or service may be used. Any functionally 
equivalent product, program, or service that does not infringe any of IBM's intellec¬ 
tual property rights or other legally protectible rights may be used instead of the 
IBM product, program, or service. Evaluation and verification of operation in con¬ 
junction with other products, programs, or services, except those expressly desig¬ 
nated by IBM, are the user's responsibility. 

The following terms, denoted by an asterisk (*) in this publication, are trademarks of 
the IBM Corporation in the United States and/or other countries: 


VM/XA 

Virtual Machine/Extended Architecture 


BookManager 

BookMaster 

DrawMaster 

GDDM 

ProcessMaster 
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About This Book 


This book describes the online documentation provided with the Virtual 
Machine/Extended Architecture System Product Release 2.1 (VM/'XA SP2.1) 
product. This documentation is of two types: 

• Base documentation that is provided with the product when it is shipped 

• Program update information that becomes available from time to time during 
the life of the product. 

The online feature of VM/XA SP2.1 contains both the nonlicensed books from the 
base library and any program update information manuals that are available. 

Note: During the life of this product, new program update information may become 
available. Periodic updates to the feature tapes will be made containing the 
added information. 

Throughout this book, online means information made available in machine-readable 
form that can be searched and viewed at a display terminal. For the definitions of 
the terms used in this guide see “Terms Used in This Book.” 

The SP2.1 online library is available in two forms: 

• Source files containing text and art that can be formatted for either printing or 
display 

• BOOK files formatted to be displayed using the BookManager Read program 
product. 

This booklet covers both forms. It is not designed to make you an expert in using 
online information, or in using the other products that are associated with using 
online information. Instead, this book should serve as a quick guide to more 
detailed sources of information. A bibliography at the end of this book provides a 
list of the manuals associated with each of the products that may be used with online 
documentation. 

Note: This manual is available in two forms: as a printed book, and as one of the 
online books on tape. Because of this, the online version of the book may 
contain additional information that could not be included in the printed 
version, and should be considered the more current one. 


Who Should Use This Manual 

This manual is intended to be used by those people who are responsible for receiving 
and installing the online information from IBM. 


Terms Used in This Book 

A number of IBM products are mentioned in this guide. In addition, there may be 
some unfamiliar terms used. These products and terms are defined below. 

Term Definition 

ADMGDF A file used by GDDM to store a graphics picture in 

GDDM's graphics data format (GDF). 
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ADMIMG 

RookManager 

BookManager BUILD 
RookManager READ 
BookMaster 

control word 

DrawMaster 

DCF 

GDDM 

GML 

GRAFFILE 

Online 

ProcessMaster 

PSEG 

SCRIPT 

tag 


A file used by GDDM to store an image picture in 
GDDM s standard image format. 

A family of program products (BookManager BUILD 
and BookManager READ) that lets you create and 
display online books. 

A program product that creates online books from 
SCRIPT source files. 

A program product that allows you to search, read, and 
annotate online books. 

A generalized markup language that is more extensive 
than the GML Starter Set. 

In SCRIPT, an instruction that causes a certain format¬ 
ting result. 

A program product that creates and edits graphics data. 

Document Composition Facility. An IBM licensed 
program for formatting documents for printing. It works 
with BookMaster. 

Graphical Data Display Manager. An IBM licensed 
program for displaying graphical information on termi¬ 
nals. 

Generalized Markup Language (GML). A language used 
to identify the elements of a source document without 
respect to specific formatting. 

A file created by a graphics editor like DrawMaster that 
contains the information needed to display one picture. 

Available interactively at a computer display device. 

An IBM licensed program that allows easy access to a 
wide variety of other IBM programs, such as BookMaster 
and DCF. 

An object containing composed text and images, prepared 
before formatting and included in a document by 
SCRIPT. 

A file type used by DCF to contain textual information 
including GML and BookMaster tags, 

In GML markup, a name for a type of document or docu¬ 
ment element. For example, :p might be the tag used to 
identify a paragraph. 
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VM/XA SP Books Shipped 

Table 1 and Table 2 on page 2 list the manuals shipped as part of the online fea¬ 
tures that are from the Virtual Machine/Extended Architecture* System Product 
(VM/XA* SP) Release 2.1 library. These tables show the form number for each 
manual, the master file name, and the tape file number. Table 2 on page 2 lists the 
program update information manuals, that update one or more books in the base 
library. 

How the names are formed that are under “Master File Name” is explained in more 
detail in “How Books Are Organized” on page 4. 

Note: In the following table, titles marked with an asterisk contain minor editorial 
changes 


Table 1 (Page 1 of 2). VM/XA SP2.1 Base Library Books Shipped on Tape 

Book 

Form Number 

Master File 
Name 

Tape File 

Using Online Documentation* 

GC23-0522 

LABZMST 

1 

Application Development Guide for FORTRAN and 
COBOL* 

SC23-0369 

LAAOMST 

2 

CMS Application Program Conversion Guide * 

SC23-0403 

LAA1MST 

3 

CMS Application Program Development Guide * 

SC23-0355 

LAA2MST 

4 

CMS Application Program Development Reference * 

SC23-0402 

LAA3MST 

5 

CMS Command Reference 

SC23-0354 

LAA4MST 

6 

CMS User's Guide 

SC23-0356 

LAA5MST 

7 

Conversion Notebook 

SC23-0357 

LAA6MST 

8 

CP Command Reference 

SC23-0358 

LAA7MST 

9 

CP Programming Services 

SC23-0370 

LAA8MST 

10 

Directory of Programming Interfaces for Customers 

GC23-0434 

LAAAMST 

11 

Dump Viewing Facility Operation Guide and Refer¬ 
ence 

SC23-0433 

LA ABM ST 

12 

EXEC 2 Reference 

SC23-0361 

LAACMST 

13 

GCS Command Reference 

SC23-0433 

LAAEMST 

14 

General Information 

GC23-0362 

LA ADM ST 

15 

Installation and Service * 

SC23-0364 

LAAFMST 

16 

Library Guide, Glossary, and Master Index 

GC23-0367 

LAAGMST 

17 

Planning and Administration * 

GC23-0378 

LAAHMST 

18 

Real System Operation 

SC23-0371 

LAAKMST 

19 

System Messages and Codes Reference 

SC23-0376 

LAALMST 

20 

System Product Editor Command and Macro Refer¬ 
ence 

SC23-0372 

LAANMST 

21 
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Table 1 (Page 2 of 2). VM/XA SP2.1 Base Library Books Shipped on Tape 

Book 

Form Number 

Master File 
Name 

Tape File 

System Product Editor User's Guide 

SC23-0373 

LAAOMST 

22 

System Product Interpreter Reference 

SC23-0374 

LAAIMST 

23 

System Product Interpreter User's Guide 

SC23-0375 

LAAJMST 

24 

Virtual Machine Operation 

SC23-0377 

LAAMMST 

25 

Guide to Saved Segments 

SC23-0457 

LAAZMST 

26 

CMS Primer 

SC23-0368 

LABYMST 

27 

Release Guide 

GC23-0510 

LAB9MST 

28 


Table 2. Program Update Information Manuals Shipped on Tape 

Book 

Form Number 

Master File 
Name 

Tape File 

Serviceability Enhancements APAR VM37518 

GC23-0503 

LABCMST 

29 


Table 3 lists the books not included in the online VM/XA SP2.1 library. 


Table 3. VM/XA SP2 Books not Shipped as Online Information 

Book 

Form Number 

CMS Data Areas and Control Blocks 

LY27-8051 

CMS Diagnosis Reference 

LY27-8052 

CP Data Areas and Control Blocks 

LY27-8053 

CP Diagnosis Reference 

LY27-8054 

Diagnosis Guide 

LY27-8056 

Feature Summary 

LY27-8058 

GCS Diagnosis Reference 

LY27-8060 

Licensed Program Specifications 

GC23-0366 

Quick Reference 

SX23-Q391 
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Differences Between Online Books and Printed Manuals 

Because of the differences between printed and online books, certain features of the 
printed manuals are not present in the online versions. These differences are summa¬ 
rized below: 

• Library Guide, Glossary, and Master Index is printed in 2-column format, but is 
displayed online in one column. The foldout page at the end of the printed 
book is not reproduced in the online version. 

• System Messages and Codes is printed in 2-column format, but is displayed in 
1-column format. 

• CP Programming Services appendixes A, B, and C must be printed using a line- 
printer, for example a 3800 model 1. These appendixes cannot be displayed 
using BookManager*. 

• The reference card at the back of the CMS Primer is not included in the online 
information. 


What is On the Distribution Tapes 

Online documentation for VM/XA SP2.1 is available in two forms: 

• Source files 

• BookManager displayable files. 

Both features are available on tape. Displayable files are shipped to all customers. 
For information on ordering the source feature, see your IBM marketing represen¬ 
tative. 

Each tape contains all of the books listed in Table 1 on page 1, but in different 
formats. The source tape contains SCRIPT files, which contain text, GRAFFILEs 
(the online art files created by DrawMaster*), PSEG3820 files (the printable versions 
of the GRAFFILEs), and ADMGDF files (the displayable versions of the 
GRAFFILEs). 

The BookManager tape contains files with the filetype of BOOK. These are the dis¬ 
playable versions of the manuals. 

Both tapes are created with the VMFPLC2 command. 

Tape Arrangement 

Each feature tape is arranged in the following order: 

• Tape file 1—The Memo to Users, which includes the files for Using Online Doc¬ 
umentation t, and a list of all the files contained on the tapes, VMXASP21 
PARTLIST. 

• Tape files 2 to 29—Book files. Each tape file contains all the files for a partic¬ 
ular book. See Table 1 on page 1 and Table 2 on page 2 for their order. 
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Removing the Files from the Tape 

The files may be removed from the tapes with the CMS VMFPLC2 LOAD 
command. To load a specific book you should position the tape at the correct tape 
file and use VMFPLC2 LOAD * * n, where n is the filemode of the disk where the 
files are to be loaded. 

Space Requirements 

Each source version of a book is made up of a different number of files. The dis- 
playable version of any book has only one file associated with it. The source 
SCRIPT and art files require approximately 200 cylinders of 3380 disk storage, in 
4kb blocks, or the equivalent. The BOOK files require approximately 100 cylinders 
of 3380 disk storage. 

For information on the names of the files that make up each book see the 
VMXASP21 PARTLIST file, which is in the first tape file on the feature tapes. 


How Books Are Organized 

Each book has a similar physical layout. A book is made up of one master file, for 
example LAA1MST. Within this file are the BookMaster* macro tags for imbed¬ 
ding all of the other files that make up the book, such as LAA1PRE and 
LAA1GLO. Most books have only one level of imbedding, but some may have 
additional levels. 

Naming Conventions 

All of the books in the library follow a naming convention. All of the files associ¬ 
ated with a particular book begin with the same 4-character code. The next four 
positions of the filename are used to identify the particular file. For example, all the 
files associated with CMS User's Guide begin with the characters LAA5. The master 
file for CMS User's Guide is LAA5MST. 
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Common Filenames 

The last four characters in the names of certain types of files are common 
throughout the SP2.1 library. Table 4 lists these files and describes their function. 


Table 4. Common VM/XA SP2 Filenames 

Filename 

Purpose 

xxxxMST 

The master file. Other files are imbedded here. 

xxxxSET 

The setup file, containing control information. 

xxxxPRE 

The preface 

xxxxBIB 

The bibliography 

xxxxSOC 

The summary of changes 

xxxxGLOS 

The glossary 

xxxxLIBl 

The first half of the VM/XA SP2.1 library diagram 

xxxxLIB2 

The second half of the VM/XA SP2.1 library 
diagram 


Not all books contain all of these pieces of information, but those that do will follow 
this naming convention. 


Filetypes 

The filetype for online files may be one of several kinds, based on the contents of the 
file. The filetypes are important because the various programs expect certain 
filetypes. For instance, BookManager expects the filetype BOOK for displayable 
files. Table 5 describes the various filetypes and their contents. 


Table 5. Soft Copy Filetypes 

Filetype 

Purpose 

SCRIPT 

Text source files, containing SCRIPT control words 
and BookMaster tags 

GRAFFILE 

DrawMaster art source files 

PSEG3820 

The printable version of a GRAFFILE 

ADMGDF 

The BookManager viewable version of a 

GRAFFILE 

ADMIMG 

The displayable version of a scanned image 

BOOK 

The BookManager viewable file 


VM/XA SP Books Shipped 5 









Using Online Information 


Online information may be used in a number of ways. For instance, you may want 
to use portions of several books in the VM/XA SP2.1 library to produce a “run- 
book” of essential information for computer operators. You may also wish to add 
new information to match your own facilities. Copies of these books may be printed 
as the need arises. Finally, using the BookManager product, BOOK files may be 
displayed on terminals, allowing quick access to the information in the entire library. 


How to Tailor Books 

The information on the source feature tape may be tailored to meet your specific 
needs. Once you have changed the SCRIPT files, you may either reprint the manual 
using BookMaster, or rebuild a displayable version using BookManager. The 
GRAFFILE may be edited using DrawMaster, and new PSEG3820 or ADMGDF 
files may be created from it. The different filetypes require different editors. The 
table below lists the editors needed for each filetype. 


Table 6. Source File Editors 

Filetype 

Editor 

SCRIPT 

Any text editor such as XEDIT or ISPF/PDF to add the 
SCRIPT and BookMaster tags. (See note.) 

GRAFFILE 

DrawMaster or another graphics editor. The new file may 
be converted to a PSEG38xx or ADMGDF file using 
DrawMaster. 

BOOK 

Cannot be edited 

ADMGDF 

Cannot be edited 

ADMIMG 

Cannot be edited 


Note: SP2.1 books contain two forms of art: DrawMaster-generated GRAFFILEs, 
and character graphics. Character graphics are contained within the SCRIPT 
files, but they cannot be edited using normal text editors. In order to display 
and edit these pieces of art successfully you will have to use the 
ProcessMaster* character graphics editor. See IBM Publishing Systems 
ProcessMaster Character Graphics Editing , SC34-5036, for more information. 
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How to Print Books 

The way you print manuals from the source SCRIPT files depends on the way your 
individual site has configured your system. In general, the command to format and 
print a book from SCRIPT files is: 

SCRIPT file-id (options ... 

The options that you use will depend upon what sort of printer the output is directed 
to. Remember that the VM/XA SP2.1 books have been written with BookMaster 
tags. This means that BookMaster must be installed for the books to format cor¬ 
rectly. Although BookMaster can produce output for a number of different devices, 
the SP2.1 library has been created for printing on an all points addressable device, 
such as a 3820 page printer. Art created with page segments cannot be printed on 
non-all points addressable printers, such as the 3800 mod 1. Different page sizes for 
different printers may also determine how the books look. You should consult the 
BookMaster manual to determine which printers BookMaster supports. 


How to Display Books 

The BOOK files from the BookManager feature tape may be viewed using the 
BookManager READ licensed program. To begin using BookManager READ you 
should issue the following command: 

B00KMGR 

BookManager READ is meant to allow you to use online books in the same way 
that you have always used printed information. For more information on using 
BookManager READ see “BookManager READ” on page 10. Although 
BookManager READ can be used on any terminal that is supported by GDDM*, 
different terminals have different display characteristics. You may not achieve iden¬ 
tical results when viewing books on different devices. 


How To Build Books 

If you are going to use BookManager BUILD to prepare displayable files for 
viewing, you must have access to the SCRIPT source files. You must have DCF for 
books using SCRIPT control words and starter set GML tags. If you are going to 
build IBM-supplied books, you will also need the BookMaster program product. 

The basic command to build a book is: 

BUILD file-id (options... 

For more information on building books see “BookManager BUILD” on page 10. 
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Product Information 


The following lists of books will help you better understand the various products 
that can be used with online information. These manuals should be consulted for all 
technical questions regarding the individual products. These lists are not meant to 
be exhaustive. In all cases, the bibliographies provided with each product should be 
consulted for additional information. 


Document Composition Facility 

• IBM Document Composition Facility: SCRIPT/VS Language Reference, 
SC34-5008 

• IBM SCRIPT Mathematical Formula Formatter User's Guide, SH20-6453 

• Text Programmer's Guide, SH35-0069 

• General Information, GH20-9158 

• Generalized Markup Language Starter Set User's Guide, SH20-9186 

• GML Starter Set Reference, SH20-9187 

• GML Starter Set Implementation Guide, SH35-0050 

• GML Concepts and Design Guide, SH20-9165 

• DCF Diagnosis Guide, SY35-0067 

• DCF Messages, SH35-0048. 


BookMaster 

• IBM Publishing Systems BookMaster General Information, GC34-5006 

• IBM Publishing Systems BookMaster User's Guide, SC34-5009 

• IBM Publishing Systems BookMaster Creating Named Styles, SC34-5008. 


ProcessMaster 

• IBM Publishing Systems ProcessMaster General Information, GC34-5031 

• IBM Publishing Systems ProcessMaster Editing, SC34-5035 

• IBM Publishing Systems ProcessMaster Character Graphics Editing, SC34-5036 

• IBM Publishing Systems ProcessMaster User's Guide, SC34-5033. 


DrawMaster 

• IBM Publishing Systems DrawMaster General Information, GC34-5021 

• IBM Publishing Systems DrawMaster Introduction, SC35-5023 

• IBM Publishing Systems DrawMaster User's Guide and Reference, SC34-5022. 
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BookManager 

• BookManager General Information, GC23-0447. 

BookManager BUILD 

• Installation and Customization, SC23-0451 

• Preparing Online Books, SC23-0450. 

BookManager READ 

• Getting Started and Command Summary, SC23-0448 

• Displaying Online Books, SC23-0449 

• Installation and Customization, SC23-0455. 


Additional Information 

• GDDM, Version 2, Release 1 Base Programming Reference, SC33-0332 

• GDDM, Version 2, Release 1 Guide for Users, SC33-0327 

• APL2 Programming: System Services Reference, SH20-9218 

• APL2 GRAPHPAK: User's Guide and Reference, SH20-9230. 
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IBM systems. You may use this form to communicate your comments about this publication, its organization, or 
subject matter, with the understanding that IBM may use or distribute whatever information you supply in any way it 
believes appropriate without incurring any obligation to you. Your comments will be sent to the author's department 
for whatever review and action, if any, are deemed appropriate. 
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requests for copies of publications, or for assistance in using your IBM system, to your IBM representative or to 
the IBM branch office serving your locality. 
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Reader's 
Comment Form 


How did you use this publication? 


□ 

As an introduction 

□ 

As a textbook (student) 

□ 

As a user's guide 

□ 

As a textbook (instructor) 

□ 

As a reference manual 

□ 

For another purpose (explain) 


Is there anything you especially like or dislike about the organization, presentation, or writing in this manual? Helpful 
comments include general usefulness of the book; possible additions, deletions, and clarifications; specific errors and 
omissions. 

Page: Comment: 
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If you wish a reply, give your name and address: 


IBM branch office serving you: 


Thank you for your cooperation. Please give this form to your IBM branch office or IBM representative who will be 
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